home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / text / manipulation / raline20.lha / randomline / DOC < prev    next >
Encoding:
Text File  |  1993-10-28  |  6.4 KB  |  210 lines
  1.  
  2.  
  3.               Welcome to the famous world of RandomLine
  4.                            (OS 2.0+ only!)
  5.  
  6.  
  7. Part I: RandomLine
  8.  
  9. This  isn't  a  typical program of J.Schmitz [SOFT] - it is a CLI-only
  10. program,  so  there  is  no Intuition-GUI (all right, there is one but
  11. this is only a short editor for the main program!)
  12.  
  13. This is no fault, it's a freature.
  14.  
  15.  
  16. Why?
  17.  
  18. RandomLine  inserts  a  randomly selected line of a list of text lines
  19. into any given ascii file.
  20.  
  21.  
  22. What for?
  23.  
  24. RandomLine  is designed for a typical FIDO-Tosser. If you write a mail
  25. and start RandomLine after that a special text could be added.
  26.  
  27.  
  28. How?
  29.  
  30. That  quit  easy.  Just  insert  in  your mail (e.g. in the opening or
  31. closing)  the  text  "{RLINE}" (without quotation marks). This will be
  32. replaced  by  RandomLine. Since version 1.2 there were different files
  33. with  text-lines supported! The pattern"{RLINE}" is still used but you
  34. can  also  use  "{RLINE.1}" or "{RLINE.2}" etc. for another text file.
  35. This  one  has  the  same DOS-Filename but the suffix ".1", ".2", etc.
  36. added!
  37.  
  38.  
  39. Install:
  40.  
  41. There  are  some things you must do before you can use RandomLine. But
  42. you  MUST  HAVE  some  knowledge  of using the CLI (I think, a user of
  43. TrapDoor should already have this ;-)).
  44.  
  45. Place  RandomLine  in a directory you want (e.g. Mail:bin), that start
  46. it  with  the  parameter S or SCRIPT. RandomLine will ask you where to
  47. place a DOS-Script. This script is used to start first you editor (for
  48. writing      a     mail)     and     then     RandomLine     (Example:
  49. Mail:Scripts/Editor.script).
  50.  
  51. Then the name and path of your editor is asked (e.g. c:ed).
  52.  
  53. Finally  you must enter the name & path of a ASCII file that countains
  54. the text that should be added randomly (e.g. Mail:Scripts/Tags).
  55.  
  56. Then  the  script  will  be  written.  Now  start  you  tosser (or the
  57. prefs-installer of it) and change the name and path of the editor into
  58. this:
  59.  
  60. execute <name of DOS-Script>
  61. (Example: execute Mail:Scripts/Editor.script)
  62.  
  63.  
  64. STOP!
  65.  
  66. Before  you  write  your  first mail you have to build a file with the
  67. texts that should be added. (was Mail:Scripts/Tags in the example)
  68.  
  69. Therefor  start  RandomLineEditor  (more  in Part II) with the name of
  70. your  ASCII  tag-file.  Since  version 2.0 the text file has a special
  71. format  that  has also binary fields in it. So don't edit the tag file
  72. with  any  text  editor!!  (RandomLineEditor  handles  this  for you!)
  73. (Before version 2.0 the tag file was a simple ASCII file.)
  74.  
  75. Don't forget!
  76.  
  77. fill-in: {RLINE}
  78. or:      {RLINE.n] were n stands for a number from 1 to what you want
  79.  
  80.  
  81. Part II: RandomLineEditor
  82.  
  83. Since  version  1.0  of the randomline package there is a special nice
  84. editor for the lines. It is quit easy to us - that's why I wrote it.
  85.  
  86. After  starting  it  (Workbench or CLI) you will asked for the name of
  87. the  text file by an ASL-Filerequester. Then its text will be shown in
  88. the listview in the main window.
  89.  
  90. Below  this listview you can see a string gadget - here you can edit a
  91. selected  text  of the listview. To accept this changed you MUST press
  92. RETURN.
  93.  
  94. Under  this  listview  &  string  gadget are five buttons. Five in the
  95. upperpart:
  96.  
  97. NEW        - adds a new textline marked with "-- new --"
  98. DELETE     - removes the selected text of your text list
  99. LOAD ASCII - adds the lines of an ASCII-file (choosen by
  100.              File-Requester)
  101. ABOUT      - some more about RandomLineEditor
  102. TEXT MODE  - selectes one of the two RandomLine modes:
  103.              INSERT    - simply inserts a random text, following
  104.                          text may be moved right
  105.              OVERWRITE - the random text overwrites the existing text
  106.  
  107. Why  OVERWRITE?  Maybe you have build up a nice signature with borders
  108. (etc.)  you  can put a random text INSIDE your border without damaging
  109. it! (ahh - nice freature!)
  110.  
  111. The  both  lower  gadgets  will  SAVE  this  text list or simply leave
  112. without saving (CANCEL).
  113.  
  114. That's it! Quit easy to use!
  115.  
  116.  
  117. Part III: How to Register
  118.  
  119. RandomLine  is  a  shareware program. This means you can copy it (only
  120. with  its  other files, like this manual), test and use it. But if you
  121. want to use it for more than 4 weeks you'll have to register.
  122.  
  123. Then  you  will receive a keyfile and you can use more than 5 tag-line
  124. (sorry,  I've  forgotten  to  tell  you:  If  you use the unregistered
  125. version of RandomLine you can only use 5 tag-lines!).
  126.  
  127. Register-fee for RandomLine is 20.-- DM (German Marks). Other currency
  128. are not accepted!
  129.  
  130. Use  the  program "REGISTER" of this file package. It will ask for all
  131. needed  information  and  print  a  letter (or write a file) which you
  132. should  sign  and  send  to me. Choose the way of paying and receiving
  133. your key.
  134.  
  135.  
  136. Part IV: Copyright, author's words
  137.  
  138. RandomLine Main program:
  139.  
  140.         Program is written with KICK-Pascal of MAXON-Computer
  141.  
  142.         copyright (c) 09/1993 by J.Schmitz [SOFT] - shareware
  143.                             fee: DM 20.--
  144.  
  145.                   use program register to register!
  146.  
  147.  
  148. RandomLine Editor:
  149.  
  150.         Program is written with KICK-Pascal of MAXON-Computer
  151.  
  152.         copyright (c) 09/1993 by J.Schmitz [SOFT] - freeware
  153.  
  154.  
  155. Why randomline?
  156.  
  157. Hm - because why not? This is another kind of origin and you could
  158. place it anywere you want to!
  159.   
  160.  
  161. My address:
  162.                             Jürgen Schmitz
  163.                              Bergstr. 82
  164.                          D-56859 Bullay/Mosel
  165.  
  166.  
  167. FidoNet address:
  168.                     Juergen Schmitz, 2:245/5630.3
  169.  
  170.  
  171. AmigaNet address:
  172.                     Juergen Schmitz, 39:172/401.2
  173.  
  174.  
  175. SkyNet address:
  176.                      Juergen Schmitz, 166:401/6.0
  177.  
  178.  
  179. Part V: What is .SPRINT?
  180.  
  181. ".SPRINT"  is  a  info file for the famous printing tool "SuperPrint".
  182. This   ".SPRINT"   file   contains  all  required  information  for  a
  183. TabelOfContens  that  could  be generated by SuperPrint (since version
  184. 3.0). As always this manual has its .sprint file.
  185.  
  186. You could request SuperPrint at Rheinland-Box (2:245/5630).
  187.  
  188.  
  189. That's it! ;-)
  190.  
  191.  
  192. Part VI: History
  193.  
  194. before V 1.0: beta-versions, without RandomLineEditor
  195.  
  196. Version 1.0: first official release, including RandomLineEditor
  197.  
  198. Version 1.2: 2nd release, supporting different text-files
  199.              (ATTENTION: please re-install RandomLine - the
  200.               startup-template of the CLI-Program has changed! The
  201.               name of the temp-file is now given to RandomLine in the
  202.               CLI-Template)
  203.  
  204. Version 2.0: 3rd release but completely new text file type (open for
  205.              later changes!)
  206.              OVERWRITE/INSERT mode
  207.              load ASCII-function in the editor
  208.  
  209. JS/10
  210.